Skip to content

chore(docs): update Console URLs after organization nav refactor#2555

Open
mszekiel wants to merge 3 commits into
masterfrom
chore/console-organizations-url-update
Open

chore(docs): update Console URLs after organization nav refactor#2555
mszekiel wants to merge 3 commits into
masterfrom
chore/console-organizations-url-update

Conversation

@mszekiel
Copy link
Copy Markdown
Collaborator

@mszekiel mszekiel commented May 15, 2026

The Ory Console moved organization management out from under Authentication to a top-level entry, and the detail page now uses a left-rail layout with dedicated routes per sub-section. The Onboarding Portal screenshots in the kratos organizations doc point at the old console.ory.sh/projects/<id>/authentication/organizations/<id>/edit URL — this PR points them at the new /organizations/<id>/onboarding-portal route.

Companion to ory-corp/cloud#11899.

The old URL keeps working via a permanent redirect, but this update keeps the docs in sync with the live UI.

Summary by CodeRabbit

  • New Features
    • Organizations is now accessible as a dedicated top-level menu item in the console, providing improved navigation and easier access for administrators.
    • New organization management features: Organization Details, B2B Single Sign-On (SSO) configuration, Onboarding Portal management, SCIM integration, and Identities administration tools are now available.

Review Change Stack

The Ory Console moved organization management out from under Authentication
to a top-level entry, and the detail page now uses a left-rail layout with
dedicated routes per sub-section. Update the screenshot URLs accordingly.

Companion to ory-corp/cloud#11899.
Copilot AI review requested due to automatic review settings May 15, 2026 10:35
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Kratos organizations documentation to reflect the new Ory Console organization onboarding portal route after the navigation refactor.

Changes:

  • Replaces old Authentication-scoped organization edit URLs with the new top-level organization onboarding portal URLs.
  • Keeps onboarding portal screenshots aligned with the current Console UI route.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@mszekiel mszekiel changed the title chore(kratos): update Console URLs after organization nav refactor chore(docs): update Console URLs after organization nav refactor May 15, 2026
Copy link
Copy Markdown
Member

@vinckr vinckr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mirror the Ory Console nav refactor: Organizations is now a top-level
entry with sub-routes for Overview, B2B SSO, Onboarding Portal, SCIM
clients, and Identities. Update the four ConsoleLink references in
the Kratos organizations guide so they render and link to the new
Organizations section.
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 15, 2026

Warning

Rate limit exceeded

@mszekiel has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 47 minutes and 27 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 68a54405-b86d-4ff8-8c58-f65112d99fcf

📥 Commits

Reviewing files that changed from the base of the PR and between 17e77dc and a2b6cdf.

📒 Files selected for processing (1)
  • src/components/ConsoleLink/console-nav-data.ts
📝 Walkthrough

Walkthrough

The PR restructures console navigation by relocating the Organizations section from the Authentication subsection to a top-level project navigation area. Route definitions are updated to create a new project.organizations block with expanded nested routes, and corresponding navigation path configuration is reorganized to reflect this change.

Changes

Organizations Navigation Restructuring

Layer / File(s) Summary
Project organizations routing
src/components/ConsoleLink/console-routes.ts
Route definitions reorganized: project.authentication.organizations removed and replaced with new project.organizations block containing route definitions and href generators for organizations, details, b2bSso, onboardingPortal, scim, and identities.
Organizations navigation paths
src/components/ConsoleLink/console-nav-data.ts
Navigation structure updated: Organizations entry removed from authenticationPaths, new organizationsPaths array added with sub-navigation items, and Organizations added to projectPaths wired to routes.project.organizations.route.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

🐰 Hopping through the nav with joy so grand,
Organizations find their rightful land,
From auth's deep shadow to project's bright space,
New routes and paths put things in place!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description provides context about the console refactoring, explains why the update is needed, and references a companion change, but the required Checklist section is incomplete or missing. Complete the Checklist section by checking appropriate boxes (e.g., confirming CLA signature, security review, test additions) to fully comply with the template requirements.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the main change—updating Console URLs after organization navigation refactoring—and is concise and specific.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/console-organizations-url-update

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/components/ConsoleLink/console-nav-data.ts`:
- Around line 132-150: The nav items use dynamic route templates
(routes.project.organizations.details / b2bSso / onboardingPortal / scim /
identities) which contain unresolved [organization] params and are assigned to
Path.href: string; replace those template hrefs with concrete URLs built from
the current organization context (e.g., generate organizationsPaths or call the
route helper with (project, organization) to produce a fully-resolved string) or
render those menu entries as non-clickable until params exist; update the code
locations where routes.project.organizations.* are used to consume the resolved
path string instead of the raw template.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 6d20dcdb-b461-454f-bc84-5668b84ddc71

📥 Commits

Reviewing files that changed from the base of the PR and between 7a237ee and 17e77dc.

⛔ Files ignored due to path filters (1)
  • docs/kratos/organizations/organizations.mdx is excluded by !**/*.mdx
📒 Files selected for processing (2)
  • src/components/ConsoleLink/console-nav-data.ts
  • src/components/ConsoleLink/console-routes.ts

Comment thread src/components/ConsoleLink/console-nav-data.ts Outdated
The Organizations sub-routes (Overview, B2B SSO, Onboarding Portal,
SCIM, Identities) all require an [organization] id; ConsoleLink only
replaces [project] in URLs, so those entries would render broken
links. Keep only the All organizations entry, which is the actual
target of every ConsoleLink reference in the Kratos guide.
Copy link
Copy Markdown
Member

@vinckr vinckr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thx, lgtm

@vinckr vinckr added the upstream Issue is caused by an upstream dependency. label May 15, 2026
Copy link
Copy Markdown
Contributor

@wassimoo wassimoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

upstream Issue is caused by an upstream dependency.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants